home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmStringGetNextComponent.z / XmStringGetNextComponent
Encoding:
Text File  |  2002-10-03  |  8.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt - A compound string function that
  10.           returns the type and value of the next component in a
  11.           compound string
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  15.  
  16.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttTTTTyyyyppppeeee XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt ((((_c_o_n_t_e_x_t, _t_e_x_t, _t_a_g, _d_i_r_e_c_t_i_o_n, _u_n_k_n_o_w_n__t_a_g,
  17.           _u_n_k_n_o_w_n__l_e_n_g_t_h, _u_n_k_n_o_w_n__v_a_l_u_e))))
  18.                XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooonnnntttteeeexxxxtttt     _c_o_n_t_e_x_t;;;;
  19.                cccchhhhaaaarrrr                ********_t_e_x_t;;;;
  20.                XXXXmmmmSSSSttttrrrriiiinnnnggggCCCChhhhaaaarrrrSSSSeeeetttt     ****_t_a_g;;;;
  21.                XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn   ****_d_i_r_e_c_t_i_o_n;;;;
  22.                XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttTTTTyyyyppppeeee****_u_n_k_n_o_w_n__t_a_g;;;;
  23.                uuuunnnnssssiiiiggggnnnneeeedddd sssshhhhoooorrrrtttt      ****_u_n_k_n_o_w_n__l_e_n_g_t_h;;;;
  24.                uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr       ********_u_n_k_n_o_w_n__v_a_l_u_e;;;;
  25.  
  26.  
  27.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  28.           This page documents version 1.2 of the Motif library.
  29.  
  30.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.           XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt returns the type and value of the
  32.           next component in the compound string identified by _c_o_n_t_e_x_t.
  33.           It is a low-level component function.  Components are
  34.           returned one at a time.  On return, only some output
  35.           parameters will be valid; which ones can be determined by
  36.           examining the return status.  In the case of _t_e_x_t, _t_a_g, and
  37.           _d_i_r_e_c_t_i_o_n components, only one output parameter is valid.
  38.           If the return status indicates an unknown component was
  39.           encountered, the font list element tag, length, and value
  40.           are returned.  This function allocates the space necessary
  41.           to hold returned values; freeing this space is the caller's
  42.           responsibility.
  43.  
  44.  
  45.           _c_o_n_t_e_x_t     Specifies the string context structure which was
  46.                       allocated by the XXXXmmmmSSSSttttrrrriiiinnnnggggIIIInnnniiiittttCCCCoooonnnntttteeeexxxxtttt function.
  47.  
  48.           _t_e_x_t        Specifies a pointer to a null terminated string.
  49.  
  50.           _t_a_g         Specifies a pointer to the font list element tag
  51.                       associated with the text.  The value
  52.                       XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG identifies a locale text
  53.                       segment.
  54.  
  55.           _d_i_r_e_c_t_i_o_n   Specifies a pointer to the direction of the
  56.                       text.
  57.  
  58.           _u_n_k_n_o_w_n__t_a_g Specifies a pointer to the tag of an unknown
  59.                       component.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           _u_n_k_n_o_w_n__l_e_n_g_t_h
  75.                       Specifies a pointer to the length of an unknown
  76.                       component.
  77.  
  78.           _u_n_k_n_o_w_n__v_a_l_u_e
  79.                       Specifies a pointer to the value of an unknown
  80.                       component.
  81.  
  82.  
  83.  
  84.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  85.           Returns the type of component found.  Following are the
  86.           possible values:
  87.  
  88.  
  89.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____CCCCHHHHAAAARRRRSSSSEEEETTTT
  90.  
  91.                This component is obsolete and remains for
  92.                compatibility with previous releases.  It has been
  93.                replaced by XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____FFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____EEEELLLLEEEEMMMMEEEENNNNTTTT____TTTTAAAAGGGG.
  94.  
  95.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____FFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____EEEELLLLEEEEMMMMEEEENNNNTTTT____TTTTAAAAGGGG
  96.  
  97.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____LLLLOOOOCCCCAAAALLLLEEEE____TTTTEEEEXXXXTTTT
  98.  
  99.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____TTTTAAAAGGGG
  100.  
  101.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____TTTTEEEEXXXXTTTT
  102.  
  103.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN
  104.  
  105.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____SSSSEEEEPPPPAAAARRRRAAAATTTTOOOORRRR
  106.  
  107.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____EEEENNNNDDDD
  108.  
  109.             +o  XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT____UUUUNNNNKKKKNNNNOOOOWWWWNNNN
  110.  
  111.  
  112.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  113.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee((((3333XXXX)))) and XXXXmmmmSSSSttttrrrriiiinnnnggggIIIInnnniiiittttCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))).
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.